home *** CD-ROM | disk | FTP | other *** search
/ The AGA Experience 3 / AGA Experience Volume 3 (1997)(NFA - SAdENESS)[!].iso / software / utilities / misc / finder / source / readme < prev   
Encoding:
Text File  |  1996-10-07  |  3.0 KB  |  62 lines
  1. The files in this directory are the Source files required to compile Finder V2.06
  2. You will need DICE and the Amiga includes for Exec 3.0 if you want to re-compile.
  3. Open a shell, cd into the source directory and type:
  4.  
  5. 1.> DCC Finder.c -3.0 -gs
  6.    (if you want CPU optimisation, use -020 or -030 options)
  7.  
  8. It will then compile, assemble and link to produce an executable called "Finder"
  9.  
  10. NOTE: You MUST use the -gs option as it enables the dynamic stack generator without
  11. which, Finder will crash on a spectacularly regular basis because of the fact that I
  12. know diddly squat about memory allocation in anything other than the stack. Huh!
  13.  
  14. Finder.GUI is the file for GadToolsBox.  To use it, you will need GadToolsBox
  15. v2.2b+.  However, before you can compile you will need to edit the GadTools
  16. source (sorry, but it is necessary). You must also tell GadToolsBox to generate an
  17. IDCMP Handler (even though Finder uses it's own, the defenitions are needed). This
  18. makes designing your own GUI easy. (I have included an alternative ".GUI" file, but no
  19. source).
  20.  
  21.   NOTE: If you use GadToolsBox to generate the GUI source from "Finder.GUI" you
  22.          will need to edit it first. These are the changes you will need to
  23.          make to "Finder_GUI.c":
  24.  
  25.         · Remove all of the "#include" statements. They are incorporated into
  26.            "Finder.c" (if you generate this source as anything other than
  27.            "Finder_GUI.c" you will need to change "#include "Finder_GUI.h" to
  28.            "<name>.h" where <name> is the name you use. You also need to
  29.            change the #include in Finder.c for "Finder_GUI.c").
  30. ******->   DO NOT REMOVE "#include "Finder_GUI.h"
  31.         · Change the "struct NewGadget FinderNGad[] = {" function removing all
  32.            of the "(APTR)<Gadget name>Clicked" (where <Gadget name> is the name
  33.            of the gadget concerned) to "NULL". Without this, the program will
  34.            try to call functions which don't exist.
  35.         · Remove completely "HandleFinderIDCMP( void )". This function has been
  36.            moved to "Finder.c" because it is different to the standard generated
  37.            GadToolsBox version.
  38.  
  39.   NOTE: The following changes must also be made to "Finder_GUI.h" if you use
  40.          "Finder.GUI" to re-generate it.
  41.  
  42.         · Remove the "GetString" and "GetNumber" defines.
  43.         · Remove the Library setup calls for Intuition and GadTools
  44.            ("extern struct IntuitionBase *IntuitionBase;" &
  45.             "extern struct Library       *GadToolsBase;").
  46.         · Remove the following function prototypes:
  47.            "extern int filelisterClicked( void );"
  48.            "extern int pathClicked( void );"
  49.            "extern int patternClicked( void );"
  50.            "extern int findClicked( void );"
  51.            "extern int quitClicked( void );"
  52.            "extern int helpClicked( void );"
  53.            "extern int aboutClicked( void );"
  54.            "extern int FinderCloseWindow();"
  55.            "extern int FinderVanillaKey();"
  56.            "extern int FinderRawKey();"
  57.  
  58.  
  59. For more info, see main Help file.
  60.  
  61. Chris Jones
  62.